home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga News 95
/
Amiga News 95.iso
/
dpat
/
dpat57
/
adeline
/
adeline.doc
< prev
next >
Wrap
Text File
|
1994-02-28
|
10KB
|
355 lines
***********************************************************************
************** Adeline, votre secrétaire en version 1.1 ***************
************* (c) 1994 Thomas PIMMEL **************
************ *************
************* Assemblé le 28.2.94 **************
************** ***************
***********************************************************************
1> Introduction :
Vu que j'ai une heure pour rédiger cette doc, ne traînons pas sinon
je serai en retard et les autres commenceront à festoyer sans moi.
ADELINE est un programme (si si) qui affiche des petites notes dans
un écran public. Le type même d'écran public est votre WorkBench.
Ces notes peuvent contenir jusqu'à 208 caractères. Elles s'affichent
d'après une date de début et de fin d'apparition. Des jockers permettent
de les afficher selon une période déterminée.
Deux notes peuvent être liées, leur apparition résultant alors d'une
relation logique entre leur condition d'apparition.
ADELINE ne s'exécute pas s'il n'a pas de notes à afficher. En cas de
changement de jour, il faut relancer Adeline. C'est un choix, je n'ai
pas envie d'avoir un programme qui tourne inutilement dans mon système.
Mais il existe bien d'autres fonctionnalités à découvrir dans Adeline,
je vous invite donc à suivre le reste de la documentation.
2> Moi :
Thomas PIMMEL
21 rue du Repos
68350 BRUNSTATT
Je ne suis pas responsable de tout dommage direct ou indirect
de vos disques ou de vos plantes vertes résultant ou non de
l'utilisation de ce programme. A vos risques et périls mes frères.
3> Lancement :
Pour lancer ADELINE tapez : "Adeline"
Adeline s'attend à trouver dans le répertoire courant "Adeline.db",
dans le cas contraire elle le créé (avec votre autorisation).
Vous pouvez préciser un autre nom de Base de données pour ADELINE
et bien d'autres choses encore...
Syntaxe ReadArgsienne d'adeline (tapez Adeline ?)
DATABASE/K,ADDNEW/K/S,EDIT/K/S,PUBSCREEN=PS/K,FONTNAME=FN/K,
FONTSIZE=FS/K/N,WINWIDTH=WW/K/N,WINHEIGHT=WH/K/N,QUIET/K/S:
Tous les arguments sont facultatifs.
MOT CLE EXEMPLE
---------------------------------------------------------------------------
DATABASE DATABASE MaBase.db
Par défaut la base est "Adeline.db".
ADDNEW ADDNEW
Adeline ajoute une note à la base et sort. Utile si vous avez
le message "La base de données est vide.". Cette note est une note avec
les paramètres par défaut, qui s'affiche toujours.
EDIT EDIT
Adeline ouvre la fenêtre d'édition. Cette option est indispensable
lorsque qu'aucune note n'est affichée et que vous voulez y avoir accès.
PUBSCREEN PUBSCREEN ECRAN.PIPO
Adeline cherche à s'ouvrir dans l'écran public "ECRAN.PIPO".
FONTNAME FONTNAME XEN.font
Par défaut la police utilisée est topaz.font
FONTSIZE FONTSIZE 9
Par défaut la taille de la police est 8
WINWIDTH WINWIDTH 160
Largeur de la fenêtre des notes.
WINHEIGHT WINHEIGHT 69
Hauteur de la fenêtre des notes.
QUIET QUIET
Pas de message de bienvenue...
4> Les menus
PROJET
A Propos de... A votre avis?
Quitter Plaquer Adeline
Refaire Réorganiser la base de donnée.
Suppression sur le disque des notes
détruites, vérification et suppression
éventuelle des notes obsolètes.
Remet à jour la numérotation des
fenêtres et des relations.
PREFERENCES
Couleur écriture Couleur du texte
Couleur fond Couleur du fond
Couleur alarme Couleur que doit prendre une note le jour
de l'expiration définitive du délai.
Sauver préférences Sauver ces couleurs, la position de la
fenêtre d'édition et la taille des fenêtres
de note (voir aussi Lancement 3>)
FENETRE
Editer Ouverture de la fenêtre d'édition et
chargement de toutes les notes en mémoire.
Vous pouvez aussi faire un double-click sur
une note.
Nouvelle Création nouvelle note.
Copier Copier une note.
Détruire Détruire une note (attention, cette note
se trouve toujours sur le disque. Pour la
supprimer définitivement exécuter
"Refaire"
Protégée Mettre ou enlever le flag "Protégé" (P)
qui interdit la destruction d'une note.
Visible Mettre ou enlever le flag "Visible" (V)
qui force une fenêtre à s'ouvrir.
Cachée Mettre ou enlever le flag caché (H)
qui force une fenêtre à se fermer.
Ces flags sont visibles dans la barre
de la fenêtre d'édition. Ces flags ne sont pas
automatiquement sauvés. Vous devez choisir l'option
"Valider", "Figer" ou encore "Refaire" pour sauver
ces flags.
Zoomer Activer / Désactiver le Zoom (pressez
aussi sur le gadget Zoom de la fenêtre)
Figer
Fenêtre Fige la position de la fenêtre et ses flags.
Tout Fige toutes les fenêtres.
Réorganiser Replacer les fenêtres sur l'écran.
5> Les gadgets
Dans la fenêtre d'édition se trouvent des gadgets. Ces gadgets
servent à modifier les caractéristiques des notes.
Les trois premiers gadgets servent à définir quelles notes vous voulez
modifier. Vous entrez le numéro de la note (raccourci N) ou vous
utilisez les gadgets < et >.
< Editer note précédente
> Editer note suivante
Titre Titre de la fenêtre
Défaire Retourner aux dernières valeurs sauvées
Texte Texte de la fenêtre (208 caract. max)
Tous les Jour de la semaine d'apparition ou "Tous les jours"
Date Affichage de la date du jour
De la date Date de début d'affichage
à la date Date de fin d'affichage (voir section Spécificités
étendues 6>)
Relation Relation avec une autre note (lien logique, voir section
spécificités étendues)
Avec Numéro de la note avec laquelle vous voulez avoir une
relation.
Valider Sauver vos modifications (NE L'OUBLIEZ PAS AVANT DE
CHANGER DE NOTE)
Gadget de fermeture de la fenêtre d'édition ou touche <ESC> : terminer
l'édition, recalcul des relations et des apparitions.
6> Spécificités étendues
Les dates :
Vous pouvez mettre n'importe quelle date valide dans les gadgets
"De la date" et "à la date". Vous pouvez remplacer le jour, le mois
ou l'année entière par des *. Vous pouvez taper A<nb de jours>
dans le gadget pour que Adeline mette automatiquement la date du
jour dans ce gadget + <nb de jours> (exemple A10 affichera la date
d'aujourd'hui + 10 jours).
Attention : l'algorithme est assez puissant, si vous rentrez
20/*/* 10/*/*
la note s'affichera du 20 d'un mois au 10 du mois suivant
Exemple : nous sommes le 26.2.1994
20/*/* 10/*/* du 20/2/1994 au 10/3/1994
période mensuelle
10/10/* 10/3/* du 10/10/1993 au 10/3/1994
période annuelle
10/*/* 10/*/* tous les 10 du mois
période mensuelle
*/*/1995 */*/* à partir du 1/1/1995 et
au 31/12/65535 (!)
Ces conditions d'apparition sont cumulables avec la spécification
d'un jour de semaine.
Ex: Tous les | Samedi |
De la date 1/*/* à la date 7/*/*
Affiche la note le premier samedi de chaque mois (pour le contenu
de la note demandez à Zarbi).
Les relations :
Aucune, aucune relation
Toujours, l'affichage de cette note entraîne automatiquement
l'affichage de l'autre.
AND, s'affiche seulement si l'autre est affichée.
XOR, s'affiche uniquement si l'autre n'est pas affichée.
La routine est récursive, je ne garantis pas l'effet en cas de relations
contradictoires (pas de plantages système en tous cas, pour le reste c'est
à vous de savoir ce que vous vouliez obtenir).
Limitation :
Adeline est plus à l'aise sur un disque dur, en effet Adeline
ne garde en mémoire que les notes réellement affichées et les
recharge lors d'une édition.
Adeline ne peut ouvrir plus de 14 fenêtres de notes sur l'écran
simultanément. Cela est dut à une limitation d'Exec qui ne permet
pas à une tâche d'avoir plus de 16 ports de message.
Si c'est une limite grave pour vous, payez-vous un(e) vrai(e) secrétaire,
vous en avez besoin...
7> Spécifications techniques :
ADELINE est écrit en assembleur, compatible 2.0 et 3.0.
La taille du binaire est 11316 octets.
Une note d'ADELINE prend 248 octets exactement et tout compris. Le
programme ne charge en mémoire que les notes réellement affichées à
l'écran.
ADELINE réclame la présence des libraries suivantes :
Library Version Commentaire
reqtools.library V38 (c) Nico François
intuition.library V37
dos.library V37
graphics.library
gadtools.library V37
keymap.library V37
diskfont.library
8> Allergie
Je viens de lire la doc d'un programme MINABLE distribué avec un
journal (honorable ce n'est pas lui qui est en cause) français.
L'auteur se croit drôle en proposant le source ( C ) de son programme
contre... 40FF!!!!!!!
C'est bien sûr scandaleux, on ne fait pas payer un débutant qui va
se servir de votre source pour approfondir ses connaissances sur
l'Amiga! A la limite on fait payer l'utilisation du programme.
J'en profite pour signaler que si les autres (l'Alien branque et le
Boubou) m'avaient laissé plus de place j'aurais bien mis toutes mes
sources à la disposition de la communauté Amiga (seules les sources
de Sound! sont disponibles sur cette disquette). Si vous voulez
mes sources (sauf EcoDisk) écrivez-moi en envoyant une disquette,
(si possible pas vièrge, mettez-y un module, une image ou un délire)
les timbres pour la réponse, et précisez quelle source vous voulez,
et sourtout pas d'argent pour ça!!! Je précise que mes sources
sont en assembleur (pour le C négociez avec Brice).
Ces précisions n'engagent que moi et non les autres auteurs de
cette disquette.
9> Remerciements
Brice Allenbrand (pour tests Enforcer et support moral)
La fonction _LVOReadArgs(a6)
Le café et mon neveu Antoine pour m'avoir réveillé tous
les matins TRES tôt.
Serge Gainsbourg pour la musique.
France-Inter pour les actualités.
Kronenbourg pour le support moral.
Les mauricettes du Klapp pour le support tout court.
Mon cerveau pour marcher à peu près normalement.
Le sommeil pour m'empêcher de programmer trop.
L'inventeur du débuger pour :
move.l Font(a4),a0
jsr CloseFont(a6)
(guru)
SpriteClock pour afficher 3:29
Mon lit...
Jean-Marc Boursot pour son aide dans le débugage de la
GadTools 2.0 (grr!!!!!!)
Thomas PIMMEL.x
Float à BRUNSTATT.